sides 'No, of cylinders' On decimal) interleave value: On decimal) @FREE Syntax: 
Free [devname] Usage : Displays number of free sectors on a device @GFX 



Syntax: RUN GlT 
BASIC09 to do 
GFX2([path]<funct: 
handle enhanced 
Usage : Graphics 
windowing comm 
help to users will 
<5>IDENT Syntax: 
from OS-9 memoi 
single line output 
directory @INIZ Svn 
@INKEV Syntax: Rl 
input a si 
the proo 
memory 
text files 
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memory 
directory 
module c 
Merge <] 
@MFRE3 
@MODP 
memory 
compare 
to module 
module M = mask 
Usage : Set m< 
monochrome it 
and links an CC 



ce package for 

Syntax: RUN 

BASIC09 to 

Syntax: none 

die graphics/ 

Give on-line 

of help topics 

r information 

mory -s = use 

s at execution 

ach a device 

subroutine to 

labort to 
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Procs [e] Usag 
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current data c 
execution direc 
Usage : Gives 
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[yy/mrn/dd/hh: 
Syntax: Seipr < 
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@>TMODE Syntax: 
the op 
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<modna 
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Initialize a 
from stdin 
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Hany 0S9'ers around the world are looking 
lore to 0S9 68K as the future for 0S9. The new 
hardware offerings froi Frank Hogg Laboratories, 
Toi-Cat etc and Interactive Hedia Systeis' 
HH/I, have no doubt increased the interest in 
DSK. A third coipany has now entered the scene 
offering a HC6866$ based tachine. Deliar Co. is 
advertising their Systet IV coiputer. Their 
Systei IV was presented at the Atlanta CocoFest. 

The other point of significance is of 
course the decision by Hicroware to drop support 
of 689S OSS. Nov all we need is a realistic 
price froR Hicroware for the OSS 68K operating 
systei. It does seei that the three cotpanies 
■entioned above tust have negotiated a volute 
licence with Hicroware as the HM/1 and Systei IV 
tachines, according to the ads, coie cotplete 
with Professional OSK. We also hear that 
Hicroware will no longer support Personal OSK, 
so it seeis that they are only interested in the 
coiiercial users, and as far as we can tell, are 
not too interested in the personal or hobby 
user. 

The good news is that the future for the 
OSS operating systei looks brighter than ever, 
even in the hobbyist's arena, thanks to the 
efforts of IHS, Frank Hogg and now Deliar. 



A new European OS-S User 6roup has recently 
been established, prompted iainly by the new 
entrants, IHS, Frank-Hogg, and Deliar, in the 
OSK systeis. The European 03-9 User Group has 
existed for soie tiie and supported 6869 OS-S in 
iuch the sate way the Australian OSS User Group 
has. A good deal of our expertise, if we can 
call it that, is based on CoCo OSS. 
(Hicroware's version of OSS for the Tandy Colour 

ooooooooooOOOOOOOOOOoooooooooo 
CoCo-Link 



Computer). It does seei that the "NEW 
European OS-S User Group plans to iove heavily 
into OSK, and that is no doubt the way into the 
future. This user group publishes a newsletter 
on disk with all the hard work being done by 
Peter Tutelaers and Burghard Kinzel. 

As the National OSS User Group we have a 
reciprocal ieibership arrangeient with the 
European group and exchange newsletters ,on 
disk, on a regular basis. We have legal 
distribution rights to their public doiain 
library, and they have siiilar rights. Should 
you wish to join the European group as an 
individual ieiber please contact us for details, 
we are able to provide P.D. prograttes etc. froi 
here for the norial copy charge of t2M per 
disk plus return postage. Please send your 
requests for P.O. disks to our librarian. 

NEWSLETTER Voluie 5 

You iay have noted that this first edition 
for 19S1 is also the beginning of Volute 5, and 
this is an achievetent in which we take soie 
pride. I don't think that Bob, Don or tyself 
anticipated this when we first decided to 
resurrect the National OSS User 6roup and 
produce a ionthly newsletter froa sunny 
Queensland. The ionthly presentation of 
interesting articles does becote difficult at 
tiies, and we really need sote input froi other 
teibers. So let's take 1991 our best year yet 
for teiber contributions. Send us your 
articles, reviews, cowents or questions, 



preferably on disk as a "vanilla" ASCII file. 
We can read any OSS disk fonat in 5.25" or 3.5" 
disks, or even HSDOS, RS00S fortat if you tust. 

Cheers, Gordon. 



CoCo-Link is an excellent tagazine to help you with the RS00S side of the Colour Coiputer. It is a hi- 
ionthly tagazine published by Hr. Robbie Oaizeli. Send your subscriptions to: 

CoCo-Link 

31 Nedlands Crescent 

Pt. Noirlunga Sth. 

South Australia 

Phone: <v8) 3861617 
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Patch Hfrtt for 1 Htg 
By Bob Otvritt 



I have for soae aonths now had a CRC/Disto 1 
Meg upgrade. It works very well indeed, and 
although our version of 039 does not sake full 
use of it yet, perhaps future patches will do 
so. Technically, it really requires skilled 
soldering work to install, because it requires 
installing a header onto the 63609 CPU chip. In 
the Australian CoCo 3 it is quite a tight fit, 
but with a bit of juggling it goes in QK. It 
requires a 9 volt 1 Aip plug-pak power supply to 
power the extra RAM chips, and this is not 
supplied with units sold to Australia because of 
the voltage and frequency difference in the 
■ains power. Tandy sells a suitable unit as 
catalogue nuiber 273-9651, which has a 
switchable output and lultiple plug types. One 
thing could worry soae of you though, it runs 
very hot! As I ai writing this, it is 35 degrees 
C in iy lounge, and the top of ay coaputer, 
where the extra RAM chips are is aleost too hot 
to touch. Apart froa slightly bending the 
plastic in that spot, however, the upgrade has 
not given any trouble. 

Now for the software run-down. It would 
appear that everything runs with the 1 Meg 
installed, except for a few gaaes that 'cheat' 
and directly aanipulate the hardware. However, 
unless the supplied prograaae 'aega' is run 
(preferable first-up in the startup file), QS9 
does not know about the upgrade, and all runs as 
usual. Once the 'aega' prograaae is run once (it 
does not need to be in the shell, as it is a 
once-off prograaae), QS9 will be able to use the 
extra 512k of RAH. The liaitation seeas to be 
that the systea aeaory aap is still Hailed to 
that area in the first 54k aap, and so you can 
NOT run aore prograaaes. You can, however, open 
aore windows, including graphics ones. This 
aeans you aay be able to aulti-task aore 
graphics prograaaes such as picture viewers and 
so on. 

One of the prograaaes which did not seea to 
work correctly was 'Mfree'. I did not notice 
this ayself, until one of the aeabers of the 
Brisbane usergroup pointed it out to ae on his 
coaputer. This is what it did on his aachine:- 



31k Begin End Blks Size 

25 weee tbfff is 2m 
u aeeee 

Total: 58 7Mk 



As you can see, the last part of the fourth 
line is not finished. Oddly enough, it did not 
do this on ay set-up at all. After auch head 
shaking and investigation, I found that it would 
only play up if the last 3k aeaory block was not 
being used at the tiae 'Mfree' was run. Of 
course, this to ae is like waving a red flag at 
a bull, and I HAD to find a solution. I 
disasseabled 'Mfree', and after a few hours 
poring over the result, I found that the 'Mfree' 
coaaand (rightly) assuaes that the top aeaory 
block available on the coaputer was in use, but 
because it was in fact not like that, it 
'stuffed up'. 

I say rightly, because when QS9 starts up, 
it checks for what it thinks is the top of RAM, 
and places the kernel (Q39pl, IMIT, etc) there. 
However, because 0S9 is inforaed of the increase 
in aeaory only after it has started up, it does 
not put the kernel in block *7F as it should, 
but in the old 512k top-of-RAM, which is block 
*3F. Hence, the top block reaains unused until 
the second window screen is opened. That is, 
Tera first, then, in ay systea, V7, and then w*l 
which is assigned to the top aeaory block by 
Srfdrv. The difference between ay systea and the 
other, was that I always started ay systea with 
at least three windows, and the other with only 
two. 

Anyway, what I have done, is patched 
'Mfree' , written a file to be used by Bob 
Santy's ' Ipatch', and to enable ae to give you 
all a copy of the patch file, I have written a 
Basic69 utility which creates the 'Mfree. ipc' 
file. All you who have a Disto 1 aeg upgrade, 
already have the prograaae 'Ipatch', it is on 
the disk which caae with the upgrade. For those 
of you who want to do this patch anyway, and do 
not have a 1 aeg upgrade yet, if you have 
'Ipatch' you can do the patch, if not, it is 
available froa our PO software library in the 
usual way. 



Now without boring you any further, here is the basicM prograaae: - 
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PROCEDURE ifree_patch 

it progratie to create a file called 'ifree.ipc' t) 

(t which aay be used to patch 'Mfree' to work t) 

(t correctly with the Oisto 1 Meg upgrade t) 



6633 

6*66 
0699 
009A 



66AF 



eec4 
eecs 

66DS 



66E4 
66EF 



00F6 
00F8 
00F9 

ei id 

eui 

0165 
6189 
61AD 
61D1 
01FS 
6219 
623D 
0261 
6285 
62A9 
62CD 
62F1 
6315 
6339 
035D 
6381 
63A5 
63C9 
63ED 
6411 
0421 



DIM a: INTEGER 

DIM b:BYTE 

DIM path: INTEGER 

CREATE Ipath/tfree.ipc'iyRITE 

FOR a=l TO 179 

READ b 

PUT ipath,b 
NEXT a 

CLOSE Ipath 
END 



DATA $61,*E6 
DATA *61 J *06 
DATA $66, $02 
DATA *02 / *06 
DATA $63, $62 
DATA *Eb ; *EE 
DATA *0A J *F5 
DATA *17 J $06 
DATA *06,*F7 
DATA $66,$61 
DATA *BD,*66 
DATA $66,*D1 
DATA $62^66 
DATA i04,*62 
DATA $38^43 
DATA *64 J *25 
DATA $A6,*63 
DATA *67,i26 
DATA «C,M2 
DATA *6C,*66 
DATA *01,*E8 
DATA $76, $59 
DATA *66,i66 



,♦61 


r $F3 


,♦62 


♦60 


,♦63, 


,♦61 


F *EB 


.♦F3 


♦62 


,♦66, 


,♦00 


♦02 


♦81 


♦C2 


♦82, 


,♦12 


$00 


,♦61 


♦66 


,♦61, 


,♦66 


♦87 


,♦66 


♦61 


♦66, 


,♦62 


♦66 


,♦80 


♦66 


.♦6A, 


,♦17 


♦66 


♦DD 


♦17 


,♦66, 


,♦07 


♦FD 


,♦17 


,♦66 


,*E5, 


,♦17 


♦66 


♦DF 


♦62 


,♦66, 


,♦66 


♦61 


♦4F 


♦57 


,♦62, 


,♦61 


♦66 


♦61 


♦65 


,♦60, 


,♦66 


♦61 


♦60 


♦61 


,♦61, 


,»DA 


♦66 


♦61 


♦66 


♦61, 


,♦66 


♦F7 


♦66 


♦61 


,♦60, 


,♦62 


♦66 


♦FD 


♦66 


♦04, 


,♦17 


♦66 


♦98 


♦20 


♦17, 


,♦61 


♦66 


♦66 


♦63 


♦06, 


,*A1 


♦6F 


♦CE 


♦66 


♦00, 


,♦27 


♦62 


♦26 


♦99 


♦02, 


,♦61 


♦66 


♦61 


♦41 


♦39, 


,♦66 


♦63 


♦66 


♦63 


♦A3, 


,♦47 


♦69 


♦64 


♦61 


♦EB, 


,♦60 











♦07 
♦D9 
♦02 
♦61 
♦60 
♦EF 
♦17 
♦B9 
♦66 
♦62 
♦69 
♦2E 
♦61 
♦66 
♦66 
♦6B 
♦16 
♦61 
♦62 
♦C8 



Of course, it is very iiportant to get all those bytes of data correct, so check and re-check ther 

Bob Devries 
ooooooooooOOOOOOOOOOoooooooooo 
TUTORIAL IN "C PROGRAMING 



INTRODUCTION 

This is an introduction to the 'C language 

as punning on the 'CoCo'. It is expected that 

you are faiiliar with BASIC or sioilar 



languages. 

The only tanner in which 
computer language, including C, 
write and debug a few prograts. 



to learn any 

is to actually 

This tutorial 
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will only give you a flavor of C. If you like it 
get OSS and C for your CoCo and learn how to use 
it. 

6ENERAL 

C was developed in the aid 197$'s as an 
enhancement of a language called '8', developed 
by AT & T in 1973, as an atteipt to get soae of 
the power back in PL/1, which is a 
siaplification at ALGOL 60. C becoae so popular 
that UNIX was rewritten in C. C is extreaely 
portable in the source code level. 
Unfortunately, there are aany versions of C, but 
lostly all of thea are using a subset of C. 
rlicroware C is right after Kernighan and 
Ritchie, and the only difference is in soie 
obsolete call's and Hicroware has a couple of 
QS3 calls which not exist under UNIX. All calls 
are kept with the UNIX naae under 0S9. 

DESCRIPTION 

C is a ■not-very-high-level' language. It 
generally deals with low-level concepts on the 
saae level as aacro asseablers. 
Thus, for exaaple, although it deals with 
characters, it does not deal with strings. This 
type of ruthless language salification will 
probably bother aost prograaaers already 
faailiar with APL, BASIC, or COBOL aore than any 
other feature of the language. 

C provides the control structures required 
for structured prograaaing. It requires the 
declaration of all variables used by the 
prograa. It provides a block-structured syntax 
which prevents one subroutine froa interfering 
with the variables of another subroutine, 
another highly-desirable feature of aany 
structured languages. 

VARIABLE DECLARATIONS 

As just noted, all variables aust be 
declared before their use. Variables declared 
within subroutines are called "local 8 and those 
declared outside of subroutines are called 
■global - . C has several types of basic variable 
declarations, as follows; 

int integer (usually 16 bits) 
short int short integer (usually 8 or 16 bits) 
char single character (usually 3 bits) 
float single-precision floating point 

(usually 32 bits) 
double double-precision floating point 

(usually 64 bits) 
loan int long integer (usually 32 bits) 

An array of a certain variable type is 



designated by placing the constant nuaber of 
eleaent in the array, in brackets, after the 
variable naae, in the type stateaent. 

Variable and subroutine naaes in C should 
begin with a letter and aay be coaposed of 
letters and nuabers. Soae iapieaentations allow 
underline (Hicrowarei, at(*), and dollar as 
additional subsequent syabois. Soae distinguish 
between upper and lower case letters, and soae 
do not. Soae require uniqueness in the first 
six characters (Hicroware). 

CONSTANTS 

Type "char 1 constants aay be entered as a 
single character enclosed in single quotes, or 
as a syabolic escape sequence of one of the 
following foras; 



\n 


(newline) 


\t 


(tab) 


\b 


(backspace) 


\r 


(carriage return) 


\f 


(fora feed) 


\1 


(line feed) 


\\ 


(backslash) 


V 


(single quote) 


\» 


(null) 


\nnn 


(octal nnn) 


\xnn 


(hex nn) 



Type "char 1 constants aay be used wherever "int" 
constants aay be used. However, various 
iapieaentations vary concerning the sign- 
extension or truncation eaployed in the 
conversion of type "char" to type "int 1 . 

A string constant, as in BASIC, is a 
series of zero or aore characters (or syabolic 
escape sequences) surrounding by double quotes. 

FUNCTIONS 

A C prograa is a series of one or aore 
function definitions. By convention, the first 
(or only) function executed is naaed 'aain'. 
The first exaaple happens to be exactly one 
function; 

aainC) 
{ 

printf ("hello, world\n a ); 

} 

This trivial C prograa is intended to print the 
following: 

hello, world 

and illustrates, by exaaple several points about 
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functions. The body of "Bain" is enclosed in 
open and close braces, as required for all 
functions. The library function "printf" is 
called with one string constant arguaent. The 
function call stateaent is followed by a 
seaicolcn. The function "sain" (as shown here) 
has no paraaeters, but if it did, they would be 
listed between the parenthesis, separated by a 
coata, and declared as local variables, as in 
the following function definition exaaple: 

addl(n) 
ini n; 
{ 

n = n + 1; 

return (n) 
} 

which also illustrates several iteas concerning 
functions. The priaary point is that functions 
can return values; if a function does not have 
an explicit type, it is defaults to type "inf. 
Technically, all C paraaeters are passed by 
value, not by address, Baking it aore difficult 
tc pass results back to the caller, but solving 
aany "side-effect 6 probleas. 

Results aay be returned to the caller 
through globals, arrays, or pointers, aaong 
other aethods. However, this aethod of 
paraaeter passing avoids the FORTRAN horror of 
accidentally aodifying constants, as in the case 
of passing a constant, not a variable, to the 
"addl" function. 

The EXPANSIBILITY of C is partially due to 
the ease of definition of C functions in a 
private library; "printf" is one such library 
function. 
EXPRESSIONS 

Although expressions in C aay look a little 
strange at first to soaeone faailiar with BASIC, 
there are strong parallels between the languages 
in teras of expression foraation. The 
arithaetic operations are as follows: 

+ addition 

- subtraction 

* aultiplication 

/ division 

X aoduius 

- unary negation 
++ unary increaent 

- unary decreaent 

, sequential evaluation 

The logical operations are as follows: 



&& and 



or 



! unary not 
The relational operators are as follows 



> 


greater 


>= 


not less 


< 


less 


<= 


not greater 


== 


equal 


i = 


not equal 



Note that the "equal 1 operator is a ==", not "=V 
The assignaent operator B=s is allowed inside 
expressions, and has the saae interpretation as 
outside expressions, of changing the value of 
the variable on its left side to that of the 
expression on its right. The conditional 
expression is designated by the pair or 
operators "?" and " : " when used in the following 
context: 

el ? e2 : e3 
which aay be interpreted as follows: 

if "el" is true 

the value of the expression is s e2" 
else 

the value of the expression is s e3 s 

The value of a "true 6 logical expression is 
usually non-zero, and the value of a "false 8 
logical expression is usually zero. Logical 
expressions aay be used in arithaetic 
expressions, with care. 

Parentheses aay be used, as in BASIC, to force 
grouping. Brackets are used to indicate array 
subscripts, rather than the double use of 
parentheses in BASIC and FORTRAN. 
The decreaent and increaent operators of C look 
strange initially to BASIC prograaaers. The 
increaent operator ■++" adds one to a variable 
and the decreaent operator "--' subtracts one 
froa a variable. If the operator appears before 
the variable, the variable is increaented before 
using its value, and if the operator appears 
after the variable, the variable is increaented 
after using its value. For exaaple, the 
following stateaent: 

if (n < 19) ++n; 

would cause *n B to be increaented by one if its 

value ware less 

than !(!, as would the following stateaent: 
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if (n < ie) n++; 

since the effect on V is the sate in both 
cases. But, in the 
following statement : 

if (n < 16) a[n++] = n; 

the value of "n s is increaented between uses, 

storing the value of V in a different elesent 
of "at]' 

There is an option of the assignaent 
operator "=" analogous to the increment and 

decresent operators. If the "=" is preceded by 

one of the following binary operators (call it 
■b 1 ): 

♦. -, «. ', «, «, », *, \ I 

the coapound assignaent resulting froa "5=" in 
the following expression: 

u b= expr 

is equivalent to the following expression: 

u = (u) b (expr) 

so that the following (coaaonly used) 
expression: 

w += 2 

is equivalent to the following expression: 

w = w + 2 



"t/ R can cause large chunks of a C prograa to be 
ignored incorrectly. The best advice on 
coaaents is properly to include the teraination 
on the saae line as the introduction. 

In several cases, expressions aay appear as 
stateaents. Several instances of this have 
already been shown. The priaary situations in 
which expressions are used as stateaents include 
the following: 

assignaent 
function calls 
increaent 
decreaent 
coapound assignaent 

The "if" stateaent is soaewhat siailar to 
the BASIC "if stateaent. Its syntax is as 
follows: 

if (expression) stateaent 

if (expression) stateaent else stateaent 

Note that, unlike BASIC, parentheses are 
required surrounding the control expression. 

The interpretation of the "if" stateaent is 

identical in C and in BASIC. However, the use 

of Boolean expressions in BASIC aay not be 

coapatible with the definitions of TRUE and 
FALSE in a specific C iapleaentation. 

The "while" stateaent establishes a 
structured loop in which the control condition 
is tested before the first (and any subsequent) 
executions of the body of the loop. Its syntax 
is as follows; 



in all contexts 



STATEMENTS 

The C language has only a Halted nuaber of 
stateaents, far fewer than BASIC or FORTRAN, 
since C relies on function libraries to 
iapieaent all I/O and other systea interfaces. 
Several functions have already been used without 
explanation to in this tutorial. C uses 
seaicolon to separate stateaents. whether on the 
saae or on different lines. 

The siaplest (and soaetiaes aost 
treacherous) C stateaent 

is the coaaent stateaent. It is introduced with 
*/*■ and terainated with "*/". Coaaents aay 
officially not be nested (according to K and R), 
although soae versions of C allow nested 
coaaents. Since C is noraally insensitive to 
end-of-line in aany cases, a aissing or aiscoded 



while (expression) stateaent 

and it aay be represented syabolically by a 
BASIC sequence siailar to the following: 

106 if (expression) goto 2Gfc 

goto 3&6 
200 stateaent 

qoto iee 

3ee ".. 

The "dc s stateaent establishes a structured 

loop in which the control condition is tested 

after the first (and any subsequent) executions 

of the body of the loop. Its syntax is as 

follows: 

do stateaent while (expression) 

and it aay be represented syabolically by a 
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BASIC sequence siiilar to the following: 

IN statement 

if (expression) goto IN 

The 'for 1 statement establishes a loop 
based upon three control expressions. Its 
syntax is as follows: 

for (expression!; expression2; expressions) 
statetent 



functions as if it were a 'goto - statement 
referencing an imaginary label just beyond the 
end of the statement. Its syntax is as follows: 

break 

The 'continue 1 statement causes the next 
iteration of the innermost 'do - , ■for 1 , or 
■while 1 statement to be perforted or the loop to 
be terminated, as the control expression 
dictates. Its syntax is as follows: 



and it say be represented symbolically by the 
BASIC sequence sitilar to the following: 

expression! 
IN if (expressiori2) goto 2N 

goto 3N 
2N statetentl 

expressions 

goto IN 
3N ... 

Note that the C version of the 'for' statetent 
is far tore sophisticated than is the BASIC 
version. Its interpretation is also different, 
in that it checks the condition the first tite, 
as opposed to BASIC, which does not check the 
condition the first Use. 

The "switch 1 statement provides a lulti-way 
decision schete sitilar to an iterated if (...) 
... else ... 

statement. Its syntax is as follows: 

switch (expression) 
{ 

case CI: statement; .... 

case C2: statement; 



continue 

The "return 1 statetent has already been 
discussed. It is used to return control to the 
caller of a function. Its syntax is as follows: 

return 

or 
return (expression) 

where ■expression 1 provides the value returned 
by the function, if any. If a value is 
expected, but none is provided the resulting 
value is unpredictable. If no value is expected 
but one is provided, it is discarded. 

The "goto 1 statetent is used to explicitly 
transfer prograt control to a label. The syntax 
of a "goto 1 is as follows: 

goto label 

and the syntax of a label is as follows: 

label: statetent (optional) 

where "label 1 Bust follow the rules for C 
variables and tust be defined within the sate 
subroutine or block in which it is used. 



default: statement; .... 



where the "CI 8 , "C2 H , etc. represent constants 
with the sate type as the expression and the 
■default' clause is optional. The expression is 
evaluated and Batched against "CI", , C2 H , etc. 
If a tatch is found, that sequence of statements 
is executed. If not, the "default" sequence is 
executed. If a iatch is found, a ■break", 
"continue", or "goto" is normally required to 
prevent falling thru to the next case. 

The "break 1 statement causes an inediate 
exit fro* the innermost "do", "for", "switch", 
or "while" statetent in which it appears. It 



PREPROCESSOR 

Host C cotpiiers provide a preprocessing 
capability which extends the compiler's 
usefulness in a tanner sitilar to that provided 
by aacro asse»blers. Lines beginning with "t" 
are preprocessor definition lines. Although 
there are tany preprocessor definition cottands, 
oniy the two tost cotton ones are described 
below. 

The tost cottonly-used preprocessor 
cottand is "idefine 8 . Its syntax is as follows: 



tdefine identifier string 
idefine identifier (id! ... 



idn) string 
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In the first case, subsequent occurrences of 
"identifier 1 , not in coaaents or string 
constants, are replaced by "string 1 . In the 
second case subsequent occurrences of 
■identifier" followed by the specified parameter 
list are replaced by ■string", lodified by 
paraietric replaceient of the "id!" through 
"idn" in "string". This capability is used 
priiarily for cases such as the following: 

♦define tabsize im 



This causes the preprocessor to search for 
■filenaie 1 in an operating-systea dependent 
lanner, and replace the include 1 cotiand with 
the entire contents of the file, which is, of 
course, assuaed to contain C functions, 
declarations, statements, etc. Soie 
iapleaentations allow or require alternate 
syntax of the "iinclude" statement, priearily 
concerning the inclusion surrounding the 
filename. 



int tabEtabsizel; 

since the size of an array is required to be a 
constant. Another coaaonly-used preprocessor 
coaaand is "include 6 . Its syntax is as follows: 



SUMMARY 

This tutorial began on a subset of the C 
programing language. With this in tind, you 
should understand enough to start Baking stall 
programs with help of the C aanual and one or 
twG of the aany books, written on the subject. 



iinciude "filenaae" 



ooooooooooQQQQQQOOOOoooooooooo 

Filt Dt-frigientitor 

by Bob vm der Poel 

coiients by Bob Devries 



Here's a nifty little prograaae which has 
been supplied to us by Bob van der Poel. The 
prograne is used to unfragaent a disk, so that 
files becoie aore contiguous, that is, they are 
placed in adjacent sectors on the disk. It is of 
course aost useful on a hard disk, but can be 
used on floppies as well. This is especially 
true for those who use the larger foraat 
floppies like 86 track ones. 

Bob does specify that you Bust have the 
'Kreider C Library' to be able to coapile this 
prograaae. As usual, this is available froi our 
PO library. This prograaae will also go into the 



library for those of you without the necessary C 
coapiler. 

Our thanks go to Bob for Baking this 
prograaae freely available. Yet another exaaple 
of the friendship of 089 users around the world, 
even as far as freezing British Coluabia!! 



Because of the length 
have had to split it over 
tuned for part two! 



of this prograaae, I 
two issues. So stay 



Regards, 
Bob Devries 



It File de-fragaentator. This prograi scans the current or specified 
directory(s) for fragmented files. If found the file is copied using 
pre-extension. Since OSS atteapts to keep all files contigous this 
scheae will work if there is a large enough block on the disk for 
the file in un- fragmented fore. 

No atteapt is sade in this version to de-fraqaent directory files. 

This progras will need the Krieder C library to coapile. When coapiling 
you will need to give extra aeaory to the prograa so that the recursive 
calls don't run out of RAM. "cc unf rage -a3k" seeas to work alright. 

usage: unf rag E-dr3 [directory] [..] 
d - process subdirectories 
r - report only, do not copy files 



February 1991 



Page 9 



AUSTRALIAN DS9 NEWSLETTER 



if no directory specified the current directoy will be processed 

Version l.e, July 1999. 
(c) Bob van der Poel Software 
P.O. Box 57 P.O. Box 355 
Wynndel, BC Porthill, 10 
Canada m 2NG USA 83853 

This prograa Bay be distributed freely for non-coiaercial use. All 
rights are reserved by the author. 
*/ 

iinclude <dir.h> 
iinclude <stdio.h> 
iinclude <ctype.h> 
Iinclude <direct.h> 
iinclude <errno.h> 

idefine FALSE G 
idefine TRUE 1 

Idefine BUFSI2E 8192 It buffer size is 32 sectors */ 

It Global variables tf 

direct int dodirs=FALSE; It do sub-directory flag tl 
direct int report=FALSE; It report only flag tl 
direct char teapfileC20]; 

char copybufCBUFSIZE]; 

direct int totalfls=d; It for report at end tf 
direct int totalfg=G; 
direct int total fix=j; 

it ======================================== 



Main... parse coiaand line and set flags, 
call recursive processer. 



iain(argc ( argv) 
inl argc; 
char targvtl; 
{ 

int doneone=FALSE; 
register int t; 
char Spsratt; 
char teapsirCStH; 

setbuf (stdout , NULL > ; /* unbuffered terminal i/o */ 
setbuf(stdin,NULL); 

strcpyCteipfile/unfrag.nnSf 1 ); It create unique filenaie for copies tl 
ikteip(teipfiie); 
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while( — argc>e)C 

if(C*++argv)W3« 1 - , )C 

for(parai=argv[$]+l;tparai;parai++){ 
switch(tolower(tparai)){ 

case 'd': 
dodirs=TRUE; 
break; 



report=TRUE; 
break; 

default: 

fputsCUnfrag version 1 .6\n",stderr); 
fputsCBy Bob van der Poel\n 8 ,5tderr); 
fputsCJuIy, 199e\n\n",stderr); 
fputs("Usage: Unfrag [-d] [directory] L.3\n",stderr>; 
fputsf d - process sub-directories^", stderr); 
fputs(" r - report only, do not unfrag\n B ,stderr); 
qiiit("); 
} 
} 
} 

else{ 
process(iargv)] 
doneone=TRUE: 



iffldoneone) processC."); ft no directory done, do current XI 

ft all done, do report XI 

5trcpy(te»pstr/\nTotal files checked: '); 

itoa(totalfl5,5trend(teip5tr)); 

putstteapstr); 

strcpytteepstr/VnTotal files fragmented: "); 

itoa(totalfg ( strend(teapstr)); 

putsiteapstr); 

strcpyfteapstr, "Total fixed: "); 

itoaCtotalfix^trenditeapstr)); 

puts(tespstr); 

exit(O): 



ooooooooooOOOOOOOOOQoooooooooo 
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